Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for All Channel Components

SGSetChannelUsage

The SGSetChannelUsage function specifies how your channel is to be used by the sequence grabber component.

pascal ComponentResult SGSetChannelUsage (SGChannel c, 
                                          long usage);

c

Identifies the channel connection for this operation.

usage

Contains flags specifying how your channel is to be used. The sequence grabber component may set more than one of these flags to 1. It sets unused flags to 0. The following flags are defined by the SeqGrabUsageEnum data type:

seqGrabRecord

Indicates that your channel is to be used during record operations. The sequence grabber component sets this flag to 1 to use a channel for recording.

seqGrabPreview

Indicates that your channel is to be used during preview operations. The sequence grabber component sets this flag to 1 to use a channel for previewing.

seqGrabPlayDuringRecord

Indicates that your component is to play its captured data during a record operation. If the sequence grabber component sets this flag to 1, your channel should play its captured data during a record operation, if the destination buffer is onscreen.

DESCRIPTION

The sequence grabber component can specify that a channel is to be used for recording or previewing, or both. In addition, the sequence grabber component can control whether the data captured by a channel is displayed during the record or preview operation.

RESULT CODES

notEnoughMemoryToGrab	-9403	Insufficient memory for record operation
deviceCantMeetRequest	-9408	Device cannot support grabber

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help